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Preface 


This user's guide iS a complete course of instruction, 
intended for the beginning as well asS experienced operator, 
in the Codex Document Processor (DOC). After reading this 
guide, the operator Should be able to utilize all DOC 
commands, including page format, line format, and 
input/output commands. This guide also includes samples of 
formatted text using DOC commands. 


Other Codex publications that may be of interest include the 
Codex Disk Operating System (CODOS) User's Guide, the CODOS 
Reference Manual, the EDITOR User's Guide, and the Hardware 
Reference Manuals appropriate to the user's system 
configuration, 


This manual is valid for Versions 4.0 through 5.1 of the 
Document Processor only. 
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CHAPTER 1. INTRODUCTION 


The Codex Document Processor (DOC), in conjunction with 
the EDITOR and the Disk Operating System, provides the CDX-68 
Display System with a text processing capability. This 
processing capability arranges the contents of a text file in 
a format designed by the user. The operator uses the EDITOR 
to create the input text files. Embedded in the text files 
are the DOC commands that arrange the text for display and/or 
printing. The input text files are stored on a disk or 
diskette and can be recalled upon request. 


DOC permits users to gain substantial savings in both 
the time and effort required to produce business 
documentation. Text is entered only once and stored on disk 
or diskette. AS many copieS aS required can then be produced 
on the system printer. When changes are required, only the 
corrections are typed to produce an updated document. [In 
addition, commands permit specified text (standard 
introductions, proposal boilerplate, and so on) to be 
inserted into documents at any point, further speeding 
Operations. ExtenSive operator prompting capabilities permit 
these insertions quickly and easily by even relatively 
untrained operators. 


In a typical text processing application, the operator 
uses the EDITOR text editing program to compose the document. 
Text is entered through the typewriter-style keyboard of the 
Codex Intelligent Terminal System and viewed on the display 
screen, where corrections and revisions may be made. DOC 
commands are entered along with the text to seve as 
instructions for formatting the document. A simple command 
instructs DOC to process the text file, interpret the format 
commands, and send a completely formatted document to the 
printer, disk, or terrmial display screen. 


DOC also has a multiple file feature. This allows the 
user to print standard form letters as originals, one for 
every name and address supplied by another file. 

This document assumes that the user is familiar with the 
EDITOR's methods of file building, saving, and loading. 


Hardware Support Required 


The minimum hardware configuration required to support 
DOC consists of: 


- CDX-68 Basic Display Terminal with the appropriate 
firmware options 


- 32K bytes of uSer memory (RAM) 
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- Microcomputer Module D 
- System Self-Test firmware package 


- 10 Mb Disk or 1 Mb Diskette Storage 


Optional Hardware Supported 


DOC also supports a variety of printers, including. 
Matrix and Character printers (the Codex SP Series). 


Software Support Required 


No additional software is required to run DOC as it 
comes Shipped on the system disk. 


Software Installation 

There is no software installation that need be 
performed. All DOC software is on the disk containing the 
selected software package. This disk contains DOC as well as 
the operating system and all programming languages and other 
software in the selected software package. 
DOC Features 

DOC provides the following features: 


- JOining of files together (i.e., chapters of a book) 


. Multiple file input capability (ie., form letters/address 
file) | | 


- Automatic table of contents file 

~ Automatic printing of multiple copies 

. Restart printing capability 

~- Heading/footing text specification 

. Automatic page numbering at top or bottom of page 

» Roman numeral page numbers for introductory material 
- Optional left or right justification of text 

- Optional centering of text 


». Specification of tab stops 
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DOC is a mechanism for formatting and then producing a 
finished document. The document is entered prior to using 
DOC and is stored on a diskette or disk. In order to 
understand how DOC works, it is helpful to compare the method 
of preparing a document uSing a typewriter to that of 
preparing a document uSing the EDITOR and DOC. 


When a document is to be manually typed on a 
conventional typewriter, the operator reviews the document 
and sets the margins and tab stops. If the text involves 
tables, lists, and diagrams, the typist must take even more 
time to arrange the text. 


With DOC, the operator also reviews the document and 
decides on the format. When the operator enters the document 
into the terminal, specific commands are placed into the text 
of the document. These commands tell DOC how to arrange the 
contents of the document. For example, the operator does not 
have to manually line space because once a command is entered 
in the text, DOC automatically arranges the desired spacing. 
With DOC, the operator is able to produce a final document 
quickly and efficiently; the operator's time is now devoted 
to entering the document, not arranging it. 


When all of the text is entered and stored on disk or 
diskette, DOC is called into use. The DOC commands entered 
along with the text, are then executed by DOC, and the text 
file is formatted into a finished document. 


When preparing the text file using the EDITOR, DOC 
commands are entered in the places within the text where they 
are to take effect. Since DOC commands are effective 
immediately, (except for margin commands), the placement of 
the DOC commands is crucial to the text formatting process. 
When executed, a DOC command acts immediately upon the line 
of text where it is placed. Some DOC commands are effective 
until terminated by an identical command with new variables, 
by a termination command, or by a command with new 
conditions. Other DOC commands are effective only once and 
must be re-entered each time that particular command is 
needed. DOC commands do not appear in the final printed 
version, unless specially requested (see As-Is). 


In order to expedite the use of DOC, the user should 
scan the draft of the document and determine what DOC 
commands are needed to format the document. This includes 
chapter and section headings, whether a table of contents is 
required, text headings and footings, and spacing and tabbing 
requirements. It is helpful to do some advance planning 
before you start to key in the text. 
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Decisions: 


Key in manuscript using 
DOC commands to format 
text and table of contents. 


1. How do I want the final 
draft to appear? 


2. What DOC commands do I 
use to format the manuscript 
and table of contents 

OR , 
letter and address list? 


Key in letter and address 
list using DOC commands. 


| Address 
List 


DOC processes unformatted 

LEX Gs. « 

- DOC commands instruct 
computer to extract an 
address from address list 
file. 


User asks DOC to open 
table of contents output 
file. DOC organizes 

chapter and section headings 
for table of contents and | 
processes unformatted text. | 


OR 


~ DOC commands. instruct 
computer to allow user 
to manually input address. 
The user requests the 
letter to print. 


The user requests a 
manuscript with a table 
of contents to print. 


@ isydeyo 


sqydasu0) [Terzauay 


Chapter 2 General Concepts 


Appendix A lists the DOC commands alphabetically and 
categorically. Examples of the use of DOC commands are 
contained in Appendix C. This manual frequently uses the 
terms, “input text" and "output text" in examples showing the 
use and the consequences of certain DOC commands. Input text 
refers to the text entered by the operator; output text 
refers to the text after it has been arranged by DOC. 


Spaces and Punctuation 


If several spaces (two or more consecutive spaces) are 
entered into a line of input text, DOC treats the several 
Spaces as if they were a Single space. These are the 
exceptions: spaces following a period (.), colon (:), 
question mark (?), or exclamation mark (!). 


When the above punctuation characters are used, a space 
character is inserted into the input text following the 
character. If the user wishes to have two spaces follow a 

punctuation character, a second space must be entered. If 
more than two spaces follow a punctuation character, DOC 
treats them as exactly two spaces. For example. 


Input Text: | 
Turn on power. Insert diskette, 


Output Texts; 
Turn on power. Insert diskette. 


Input Text: 
First.Second. 
First. Second. 
First. Second. 
First, Second. 
First. Second. 


Output Text: 
First.Second. 
First. Second. 
First. Second. 
First. Second. 
First. Second. 


The carriage return, (the key labelled "RETURN,") when 
used at the end of each line, is treated as a Single space. 


Note that if multiple spaces are to appear ina line of 
output text, they must be specified by the "SP" command or by 
tab specification commands, These commands are explained 
later on in this guide. 
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Default Values 


If you do not use certain DOC commands when entering © 
your text, DOC uses certain default values and formats your 
document accordingly. The following list Summarizes the most 
important default conditions. | , 


Format Aspect Default Value | 
Left Margin Column 10 
Right Margin | Column 70 

Line Justification Left 

Heading Length 7 lines 

Body Length 54 lines 
Footing Length 5 lines 
Paragraph Identation 5 columns 

Page Printing Continuous 


Appendix B lists all default conditions. Ifa DOC 
command is not used for a' particular format aspect, the 
default value, as listed in Appendix B is assumed. 


DOC Command Format 


A DOC command consists of two characters preceded by a 
reverse Slash "\" sign, with no embedded spaces. For 
example: | | 


\pp (form paragraph) 


The majority of the DOC command characters are 
alphabetic; a few use numeric and special characters. It is 
important to note that the alphabetic characters may be 
entered in either upper or lower case. All DOC commands are 
listed in Appendix A. The operator should note that CODOS 
has a "="_prompt, while DOC has a "?" prompt. 


Several of the DOC commands require arguments. 
Arguments are the numbers that define the command. The 
argument is entered with no space between the command | 
characters and the argument. A typical example is: \ppnnn. 


A space must follow the argument if the argument is 
Shorter than the allowed maximum, or if the subsequent text 
character could be mistaken for another argument character. 


If a "\" sign is to be entered into the input text as 
part of the text, it must be entered as "\\." DOC 
interprets the double reverse slash as a Single reverse 
Slash. 
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The following example letter has DOC commands in place. 
When this letter is printed, the DOC processor formats the 
letter according to the given commands and produces a 
finished letter. All of the DOC commands are explained 
further on in this Guide. This example is just to give you 
an idea of how an unformatted document with DOC commands 
appears. 


Input Text: 


\1lm10\rm70\s13 

Converging Lines, Inc. 

\nl 

Ms. Teri Herbert 

\nl 

ae East Rhode Island School of Design Terrace 
s12 

Dear Ms. Herbert 

\s12 


Thank you for your interest in WorldWide Rulers' line of 
measuring devices. We offer the eighteen-inch rulers you 
inguired about in several different materials: 
\sl2\tc\tsl5\ts25\1lm25\pl\ttl 

Wood 

\tt2 

- certainly the most natural material, and a favorite 
from long ago 

\sl2\ttl 

Plastic 

\tt2 

- the most popular material today, and available 

in a wide variety of colors 

\sl2\ttl 

Metal 

\tt2 - the most precise and durable material chosen by 
most professionals 

\sli\liml0\sll 

We can also customize your order with the imprinting of 
your commpany's logo or other design. 

\sl2 

But the most important reason for ordering from WorldWide is 
Our prompt, friendly service. We hope to, dare we say it, 
rule the world, and your continued buSiness is the only way 
we can achieve our goal. 

\sl2 

Thanks again for your interest, and we hope to be hearing 
from you soon. 

\s12\sp20 

Sincerely yours, 

\sl5\sp20 

Raoul Linear 

\nl\sp20 

Customer Service Manager 
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Several things should be noted about the example. The 
input text portion is unformatted. No attention is placed on. 
the number of spaces between words, lines, columns. Since 
the actual formatting is done only when DOC processes the 

the operator is free to enter the text in any 


text file, ) 
It is the presence of the DOC commands that indicate 


manner. 
where the lines end, where columns begin, and so on. 


Display | Printed 
Screen Letter 
Page 2-06 
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Before a final copy of a page can be produced, the user 
must be aware of the requirements of the page. The user must 
plan to size the heading, the body, and the footing of the 
page. If page numbers are to be included, they must be 
considered also. Note that the heading and footing are 
blocks of lines that may or may not have explanatory text; 
the body is a block of lines available for text. 


If DOC commands for sizing those page components are 
omitted, default lengths are automatically asSigned. 


Page numbering is omitted unless specifically requested 
using a DOC command. If page numbering is specified, the 
positioning of page numbers can be controlled by DOC commands 
or by default values. 


The list of DOC page format commands is as follows: 


Command Function 

HLnnn Specify heading length 

BHtext Begin heading text 

BLnnn Specify body length 

FLnnn Specify footing length 

BFtext Begin footing text 

ALNnn Set absolute left margin (page number) 
ARnnn Set absolute right margin (page number) 
PTXXXXX Position page number at top of page 
PBXXXXX Position page number at bottom of page 
PE Page numbers end on this page 

OP Optional "Page," print only numbers 

RP Resume printing "Page" 

RNnnn Use roman numerals for page numbers 


NOTE: The alphabetic characters used in DOC commands may be 
in either upper or lower case. 


Heading 


The heading of a page consists of a block of lines at 
the top of the page. If heading text is inserted in the 
heading block, it appears on the fourth line of the heading. 
If the heading block is less than four lines, a heading text 
cannot be inserted. Note that page numbers, if specified for 
the top of the page, appear in the heading. Refer to the 
"PT" command. 
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HL - Specify Heading Length 
Format: \HLnnn 


Where: "nnn" is a number specifying the number of lines 
in the heading. 


Note: An error occurs if the number is missing. A 
value of zero is valid. 


The default heading length is 7 lines. 


BH - Begin Heading Text 
Format: \BHtext 
Where: "text" is the data to be inserted in heading. 


Note: Text appears aS-is, Starting in column 1 of 
the fourth line of the heading block. If you 
wish to align the heading with whatever. the 
left margin is set at, insert spaces in front of 
your heading text. For example, if your left 
margin is at 10, insert 9 spaces in front of 
your heading text in order to begin heading in 
column 10. 


Text is terminated by either a ae ta sign or a 
Carriage return. 


DOC commands or "\" signs cannot be inserted in 
the heading text. 


Whenever another "BH" command and its text is 
encountered, the current heading text is 
changed to the new text. 


If a "BH" command is given with text consisting 
only of Spaces or a carriage return, the effect 
is to turn off the insertion of text in the 
headings of subsequent pages. 


Initially, the heading block is blank, i.e., if 
no "BH" command and accompanying text is 
encountered, no text appears in the heading 
block until the first "BH" command with its 
text 1S encountered. | 
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Body 


The body consists of the actual text of the document, 
The default body size is 54 lines. If the default heading 
length is used, the eighth line on the page is the first line 
of the body. When the last line of the body prints, the 
footing automatically prints, and the formatted output 
advances to the top of a new page. Chapter 4 details the 
commands that control the format for the text within the body 
of a page. 


BL - Specify Body Length 
Format: \BLnnn 


Where: "nnn" is a number specifying the number of 
lines in the body. 


Note: An error occurs if the number is missing or is 
given a value of zero. 


If the heading and footing are set to zero lines, 
continuous text is produced with no intervening 
page numbers, headings, or footings appearing on 
pages. 


The default body length is 54 lines. 


Footing 


The footing consists of a block of lines at the bottom 
of each page. If footing text is inserted in the footing 
block, it appears on the third line of the footing. If the 
footing block is made to be less than three lines, footing 
text cannot be inserted. Note that page numbers, if 
specified for the bottom of the page, appear in the footing. 
Refer to the "PB" command in this chapter. 


FL - Specify Footing Length 


Format: \FLnnn 


Where: "nnn" is a number specifying the number of lines 
in the footing. 


Note: An error occurs if the number iS missing. A 
value of zero is valid. 


The default footing length is 5 lines. 
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BF - Begin Footing Text 
Format: \BF text 
Where: "text" is the data to be inserted in footing. 


Note: Text appears as-is, starting in column ] in the 
third line of the footing block. If you wish 
to align the footing with whatever the left 
margin is set at, insert spaces in front of the 
footing text. For example, if your left margin 
Margin is at 10, insert 9 spaces in front of 
your footing text in order to begin in column 
10. 


Text is terminated by either a "\" Sign or a 
Carriage return, 


DOC commands or "\" signs cannot be inserted 
in the footing text. 


Whenever another "BF" command and its text is 
encountered, the current footing text is 
changed to the new text. 


If a "BF" command is given with text 
consisting only of spaces or a Carriage 
return, the effect 1S to turn-off the 
insertion of text in the footings of 
subsequent pages, 


Initially, the footing block is blank; i.e., 
if no "BF" command and accompanying text is 
encountered, no text appears in the footing 
block until the first "BF" command with its 
text is encountered. : 


Page Numbers 


DOC hasS Six commands that affect page numbers. DOC 
Suppresses page numbers unlesSs a page numbering command is 
given. Page numbers can be positioned at the top of the page 
or at the bottom of the page. A DOC command also exists for 
the positioning of lower caSe roman numerals which can only 
be positioned at the bottom of the page. 


DOC has two commands that position a page number in 
either the heading or the footing. An absolute left and 
absolute right margin position a page number in either the 
heading or footing text line (if page numbers are to appear). 
These margins do not affect the placement or format of text 
in the heading, body, or footing. 
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The page numbers are placed in the appropriate line 
after the heading or footing text is moved into the line, 
Thus, it is possible for the page number to overlay part of 
the heading or footing text, if poSitioning is carelessly 
done. The page numbers are always placed so that they are 
centered between the current values of the absolute left and 
right margins. Note that the word "Page" always accompanies 
the page number, unless deleted by a "OP" command. 


AL - Set Absolute Left Margin for Page Numbers 


Format: \Abunnn 


Where: "nnn" is a number specifying the column 
position of the left margin for page numbers. 


Note: The value of "nnn“ must be greater than 0, less 
than 133, and less than the current column 
position of the absolute right margin for page 
numbers. 


An error occurs if "nnn" is missing cr is 
invahid, 

The default value for the absolute iele margin 
For page numbers is column 16. | 


Page tumbers, if specified, are centered 


between the absolute left and right margins. 


AR ~ Set Absolute Right Margin for Page Numbers 
Format: \ARnnn 


Where: “nano” 28 a number specifying the column 
POSLELeCn of the right margin for page numbers, 


Note: The value of "nnn" must be greater than 0, less 
| than 133, and greater than the current column 
wosSition of the absolute left margin for page 
numbers. 


An error occurs if "nnn" is misSing or is 
invalid. 


The default value for the absolute right margin 
for page numbers is column 70. 


Page numbers, if specified, are centered 
between the absolute left and right margins. 
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Examples: 


Page Numbers 


If absolute margins are not specified and page 
numbers are to appear, the page numbers center 
between columns 10 and 70. 7 


If the command "\AL60" is given and an absolute 
right margin command is not specified, page | 
numbers appear right justified on the top or 
bottom of the page, dependent upon the page 
position command. Note that "Page xxxxx" 
consists of 10 column positions - 4 for 

"Page," 1 for a space, and 5 for the page 
numbers. | 


PB - Position Page Numbers at Bottom of Page 


Formats: 
Where: 


Note: 


\PBXXXXX 
"Xxxxx" Specifies the page number. 


Page number "xxxxx" must be exactly five 
Characters, followed by either a "\" Sign or a 
Carriage return. The fifth character must not 
be a "\" sign or carriage return. 


When the "PB" command is encountered, page 
numbers of the form: 

| Page XXXxXx ) 
appear at the bottom of each page, centered 
between the absolute left and right margins, and 
Starting with the current page. 


Page numbers increment by one for successive 
pages. 


Spaces in "xxxxx" are treated as zeros. 


Page numbering continues until the end of the 
File unless turned off by a "PE" command. 


If a new page numbering command is encountered, 
the numbering of subsequent pages is based on 
the value of "xxxxx." 


Refer to the "PT" command for page numbering 
examples. 
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PT -— Position Page Numbers at Top of Page 
Format: \PTxxxxx 
Where: "xxxxx" Specifies the page number, 


Note: Page number "xxxxx" must be exactly five 
Characters, followed by either a "\" Sign or a 
carriage return. The fifth character must not 
be a "\" sign or a carriage return, 


When the "PT" command is encountered, page 
numbers of the form: 

Page XXXXxX 
appear at the top of each page, centered 
between the absolute left and right margins, 
Starting with the subsequent page. 


Page numbers are incremented by one for 
succesSive pages. 


Spaces in "xxxxx" are treated aS zeros. 


Page numbering continues until tne end of the 
file unless turned off by a “PE" command. 


If a new page numbering command is encountered, 
the numbering of subsequent pages is based on 
the new value of “xxxxx." 


Examples: | 
The following examples illustrate the sequence 
of page numbers that generate for ene specified 
initial values: 


Example 1 Example 2 Example 3 Example 4 
\PB 1 \PB01-01 \PBO00001 \PB****] 
1 01-01 00001 REE] 

Z O1-02 00002 Ran oe 
3 01-03 00003 eeERS 
4 01-04 00004 REER SG 
S) 01-05 00005 RAR D 
6 01-06 00006 diate all « 

7 01-07 00007 eae 
8 01-08 00008 ial «| 
9 01-09 00009 A al 
10 01-10 00010 
etc. ecc, etc. 


The page numbers in Example 2 should not be used if page 
numbers are to exceed 99. Page numbers in Example 4 should 
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not be used if page numbers are to exceed 9. In both cases, 
exceeding these limits cause the generation of unrecognizable 
page numbers. 
PE - Page Number End on This Page 
Format: \PE 
Note: No argument is required, 
Page numbering iS suppressed, beginning with 
the current page, until a page numbering 
command iS encountered, or the end of the file 
is reached. 
RN - Use Roman Numerals for Page Numbers 


Format: \RNnnn 


Where: "nnn" iS a number indicating the roman numeral 


page number to be positioned at the bottom of 
the page. 

Note: The value of "nnn" must be in the range from 
1 to 20. 


Roman numerals increment by one for successive 
pages until page 20 (xx) is reached. 


Roman numerals are poSitioned at the bottom of 
each page, starting with the current page, and 
are centered between the left and right margins. 


A value of zero, no "nnn," or the "PE" command 
can be used to suppress roman numeral page © 
numbering. 


If another page numbering command is encountered, 
the new page numbering command takes effect. 
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Example: 

The following table illustrates the roman numerals 
that are available with the use of the "™\RN" 
command: 

Command Number Command Number Command Number 
\rnl i \rng viii \rnl5 XV 
\rn2 ii \rn9 xix \rnlé xvi 
\rn3 iii \rnl1o x \rnl7 XVii 
\rn4 iv \rnll Xi \rnls xviii 
\rn5 V \rnl2 xii \rnl9 xix 
\rn6 vi \rnl3 Xiii \rn20 XX 
\rn7 vii \rnl4 xiv 


OP - Optional "Page," Print Only Numbers 

Format: \OP 

Note: All of the page numbering commands described so 
Far, cause the word, "Page”™ to print before the 
page number, This command deletes the word 
"Page," 
No argument is required. 


The page numbers are positioned as specified by 
the previously described page commands. 


RP —- Resume Printing of "Page" 


Format: \RP 


Note: This command causes the word "Page" to resume 
printing. 


No argument is required. 
This command is only necessary when an "OP" 


command is used, and the operator wishes to 
resume printing of the word "Page." 
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Page Format Defaults Summary 


If no page format commands are entered, a total page 
length of 66 lines is allotted in the following proportions: 


Heading 7 lines 
Body 54 lines 
Footing 5 lines 


Page numbers are not inserted. If a page top or page 
bottom command is given, the default values are 10 for 
absolute left margin and 70 for absolute right margins. The 
page number is centered between columns 10 and 70. Note that 
the word, "Page," always accompanies the page numbers except 
when the "OP" command is used. 


The following is an example of the use of some DOC 
commands for formatting an initial page of a chapter. 


\h16 

\bhCHAPTER 1\ 
\b150 

\£14 

\b£*See Chapter 4\ 
\al60 


\pb He 
- Six lines are allotted to a heading block. 


- "CHAPTER 1" is to be inserted in the fourth line > 
of the heading, beginning in column l. 


». The body is to accommodate up to 50 lines of 
text. 


. Four lines are allotted to a footing block. 


. "*See Chapter 4" is to be inserted in the third 
line of the footing, beginning in column l. 


"Page 1" is to be inserted at the bottom of 
the page, right justified (assuming a default 

of "AR70"). Subsequent pages are automatically 
numbered, with the page count incremented by one 
for each page. | 
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The body of a page contains text that fills its allotted 
Space partially or completely. DOC commands permit the user 
to control lines of text within the body in regards to their 
horizontal spacing, vertical spacing, and line justification. 


The following is a list of DOC line format commands. 


Command 7 Function 


Horizontal Spacing 


LMnnn Set left margin 
RMnnn Set right margin 
PL Purge current output line 
SPnnn Insert spaces 
TC Clear tab stops 
TSnnn Set tab stops 
TInnn Tab to logical tab stop 
LTnnn Set left margin to logical tab stop 
RTnnn Set right margin to logical tab stop 
TBnnn Tab to absolute column 
TFnnn Tab with filler 
LDxx Define leader characters 
Vertical Spacing 
NL New line 
NE New line, even margins 
SLnnn Skip lines 
PP Form paragraph 
PPnnn Form paragraph, skipping lines 
ISnnn Specify spaces for paragraph identation 
PG Skip to top of next page | 
PSnnn Conditional skip to top of next page 
Line Justification 
LJ Left justify text 
RJ» Right justify text 
CN Center subsequent text 
EM Form even margins 
NOTE: The alphabetic characters used in DOC commands 


may 
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Horizontal Spacing Control 


Lines of text in the body need to be bound by left and 
right margins. Margin Settings for text are not to be 
confused with margins settings used for controlling the 
positioning of page numbers (see Chapter 3). 


Tabbing (the setting of tab stops) is a useful device 
for setting up columns of text or creating tables. Once the 
tab stops are set, text can be directed to the desired 
positions on the page. In addition, right and left margins 
can be reset by tab stops at times when margins need to be 
changed only temporarily from their original settings. Once 
the tab stops are cleared, the original margin settings are 
returned, | | 


LM - Set Left Margin 


Format: \LMnnn 


Where: "nnn" 1S a number that specifies a column 
position for the left text margin. 


Note: The value of "nnn" must be greater than 0, less 
than 133, and less than the current column 
position of the right margin. 


An error occurs if "nnn" iS miSSing or is 
invalid. | 


The default value for the left margin is 
column 10. 


If left and right margins are set to make an 
exceedingly narrow body, long words may not fit 
on a Single line. See the example with the "RM" 
command, 

RM - Set Right Margin 


Format: \RMnnn 


Where; "nnn" is a number that specifies a column 
position for the right text margin, 


Note: The value of "nnn" must be greater than 0, less 
than 133, and greater than the current 
position of the left margin. 


An error occurs if "nnn" iS miSSing or is 
invalid. | 
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The default value for the right margin is 
column 70. 


If left and right margins are set to make an 
exceedingly narrow body, a Single word or a 
hyphenated word may not fit on a line, even if 
it is the only word on the line. In such cases, 
the line begins at the left margin and as many 
Characters as can be accommodated are inserted. 
Then, whatever characters remain are placed on 
the following line, beginning at the left 
margin. The following illustrates this problem. 


Input Text: 
\lm35\rm45\pl 
Long words like "undifferentiated" and 
hyphenated words like "new-line-even-margins" 
have a hard time being placed into 
narrow-margined output. 


Output Text: 
| Long words 
like 
"undifferen 
tiated" and 
hyphenated 
words like 
"new-line-e 
ven-margins 
"have a 
hard time 
being 
placed into 
narrow-marg 
ined 
output. 
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PL - Purge Current Output Line 
Format: \PL 
Note: No argument is required. 


The margins of the body remain fixed until 
a margin change command is received. 

The current line being formatted has 
margins fixed by the old margin command. 
To cause a margin change to take place 
with the current line, the "PL" command 
must be given along with the new 

margin command. The effect is to purge 
the current line and reset margins to 
values supplied by the new margin 
commands. | 


The following two command sequences have the same effect 
in regards to the output text. 


Change margins after this line. \nl\1m5\rm75\p1 
But before this line. 


Change margins after this line.\lm5\rm75\nl 
But before this line, 


In the first case, the margin commands are encountered 
after the "\nl" command. If the margin commands are to be 
immediately effective (before more text is placed into the 
output line), the "\pl" command is used to purge the line. 
If any text were encountered before the "\pl" command, and 
before the line was filled (or printed), that text 1s purged 
as well. 


In the second case, the margin commands are encountered 
before the current line prints. Since the margins are not 
changed until after the line prints, the result is that the 
left and right margins are columns 5 and 75, respectively, _ 
after the "\nl" command is processed. 
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SP - Insert Spaces in Line 
Format: \SPnnn 


Where: "nnn" is a number specifying the spaces to be 
inserted in a line. 


Note: Since multiple spaces (two or more) in a line 
are always removed and replaced by a single 
Space in the output text, the "SP" command 
must be used if multiple spaces are desired. 


An error occurs if the value of "nnn" is 0, 
greater than 132, or if "nnn" is miSSing. 


Example: 
Input Text: 


This\sp3line\sp4has\sp5wide\sp6spaces.\nl 
This line does not. \nl 


Output Text: 
| This line has wide spaces. 


This line does not. 


TC - Clear Tab Stops 
Format: \TC 
Note: No argument is required. 


Commands that refer to a defined tab stop cause 
errors if used after tab stops are cleared. 


Initially, all tab stops are cleared, i.e., no 
tab stops exist until a tab stop command is 
given. 


All current tab stops are.cleared when the "TC" 
command is encountered. 


TS - Set Tab Stop 
Format: \TSnnn 


Where: "nnn" iS a number specifying a column position 
for a tab stop. 


Note: The value of "nnn" must be greater than 0 and 
less than 133. | 
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An error occurs if "nnn" iS misSing or is 


Up to 20 tab stops can be set. 


All existing tab stops should be cleared with 
the "TC" command before new tab stops are set. 


Tab stops need not be set in any particular 
ascending order, i.e., "\ts20\tsl0" is valid. 


Tab stops can be referenced by other tab 
commands, uSing logical tab stop numbers. 
Refer to the "TT," "LT," and "RT" commands. 


Example: The following DOC commands set 10 tab stops. 


\te\ts10\ts20\ts30\ts40\ts50 
\tsé60\ts70\tsl5\ts55\ts25 


The following correspondence exists between 
logical tab stop numbers and column positions. 


Logical Tab Corresponding 
Stop Number Column Position 


aw Gee Gee Ce Ge te SD Gee Qe eee cers a aE Gene Gee as ee ee GE eee pee Ge Ce Eee Ge eee 


Owomonnvoo PWN FE 
un 
© 


4 


Note that the logical tab stop numbers are in 
a logically sequenced order while column 
positions are not necessarily in any order, 
That is, tab stop 10 corresponds to column 25, 
while tab stop 9 corresponds to column 55. 
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TT - Tab to Logical Tab Stop 


Format: 


Where: 


Note: 


Example: 


\TTnnn text 


"nnn" is a number specifying a tab stop 
(defined previously by a "TS" command) by its 
logical tab stop number. Text is data to be 
inserted beginning at the tab stop. 


The value "nnn" must be greater than 0, less 
than 21, and must be specified. 


An error occurs if the logical tab stop number 
has not been defined. 


If the "TT" command causes the column position 
to be greater than the right margin, the tabbed 
text is placed on the next line, beginning at 
the left margin. 


Input Text: 


\tec 

\ts10\ts14\ts18\ts22\ts26 

\ts30\ts34\ts38\ts42\ts46 

\ts50\ts54\ts58\ts62\ts66 

\ts70 

\tt1l4 fourth. \tt3 First, \ttl0O third, \tt6 second, 
\tt16 \nl 


Output Text: 


First, second, third, fourth. 


TB - Tab to Absolute Column 


Format: 


Where: 


Note: 


\TBnnn text 


"nnn" is a number that specifies a column 
position for a tab stop. "text" is data to be 
inserted at the tab stop. 


An error occurs if "nnn" is misSing or if its 
value is 0 or is greater than 132. 


The "TB" command causes tabbing to a specific 
column position, regardless of whether or not 
previous tab stops have been set. 


If the "TB" command causes the column position 
to be greater than the right margin, the tabbed 
text is placed on the next line, beginning at 
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the left margin. 


The effect of the "TB" command is that input 
text following the command is inserted 
beginning at the specified column position. 


LT - Set Left Margin to Logical Tab Stop 
Format: \LTnnn 


Where; "nnn" is a number specifying a tab stop 
(defined previously by a "TS" command) by its 
logical tab stop number. 


Note: The value "nnn" must be greater than 0, less 
than 21, and must be specified. 


The column specified by the logical tab stop 
number must be less than the current column 
position of the right margin. 


If the left margin is to be varied, it is 
recommended that the left margin be set by 

the "LT" command rather than the "LM" command. 
Thus, when the left margin is to be changed 
only the "nnn" value of the "LT" command need 
be changed, not the "LM" command. 


Example: | 
\te\ts30\ts20\ts50\ts40\1lt2\pl 


This causes the left margin to be set at 
column 20. | 


RT - Set Right Margin to Logical Tab Stop 

Format: \RTnnn 

Where: "nnn" is a number specifying a tab stop 
(defined previously by a "TS" command) by 


its logical tab stop number. 


Note: The value "nnn" must be greater than 0, less 
than 21, and must be specified. | 


The column specified by the logical tab stop 
number must be greater than the current column 
position of the left margin. 


If the right margin is to be varied, it is 


recommended that the right margin be set by the 
"RT" command rather than by the "RM" command. 
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Example: 
\tc\ts30\ts20\ts50\ts40\rt4\pl 


This causes the right margin to be set at 
column 40. 


TF - Tab with Filler 
Format: \TFnnn text 


Where: "nnn" is a number specifying a tab 
stop (defined previously by a "TS" command) 
by its logical tab stop number (refer to 
"TS" command). "text" is data to be inserted 
at the tab stop. | 


Note: The value "nnn" must be greater than 0, less 
than 21, and must be specified. 


An error occurs if the logical tab stop 
number has not been defined by a "TS" 
command. : 


The tab stop specified must have a column 
position greater than the current column 
position, i.e., tabbing can only be done 
to the right of the current column position. 


The "TF" command can be used anywhere a 
leader is required to guide the eye of the 
reader, e.g., in a table of contents, between 
entries ina table. 


The two-character leader is defined by use 
of the "LD" command. 


The effect of the "TF" command is for text 
following the command to be inserted at the 
specified column position. The columns 
between the current column position, and the 
specified column position are filled with 

a leader defined by the "LD" command. 


If the "TF" command causes the column position 
to be greater than the right margin, the 
tabbed text is placed on the next line, 
beginning at the left margin. 


Example: The assumption is made here that no "LD" 


command has been encountered. The default 
leader characters are used (space, period). 
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Input Text: 
\tec 
\tsl0\tsl14\tsl18\ts22\ts26\ts30\ts34\ts38 
\ts42\ts46\ts50\ts54\ts58\ts62\ts66\ts70 
\tt3 Item 1 \tf£8 Item 2 \tf£13 Item 3\nl 
\tt3 Item 4 \t£8 Item 5 \tf£13 Item 6\nl 
\tt3 Item 7 \tf£8 Item 8 \tf£f13 Item 9\nl 


Output Text: 
Tem. 2 wise %. % «we & Them 2. « & we & & & Poem. 3 
foem 4. << « 4 & « « Ttem Ss. « ~ « « « » Prem. 6 
Item 7 ..... «e« Item 8 ...... item 9 


LD - Define Leader Characters 
Format: \LDxx 


Where: "xx" are any displayable characters other 
than the "\" Sign. 


Note: The leader characters fill the columns 
between the current column position and 
the column position specified by a "TF" 
command. — | 


The default characters for the leader are 
the space and period ( .). 


Example: Using three sets of leader characters, the 
following results: 


Input Text: 
\te 
\tsl0\tsl4\tsl8\ts22\ts26\ts30\ts34\ts38 
\ts42\ts46\ts50\ts54\ts58\ts62\ts66\ts70 
\ld== 
\tt3 Item 1 \t£8 Item 2 \t£13 Item 3\nl 
polis oan . 
\tt3 Item 4 \t£8 Item 5 \t£13 Item 6\n1 
\ld - 
\tt3 Item 7 \t£8 Item 8 \t£13 Item 9\nl 


Output Text: 


Ttem a SSeS ee SSeS == (ten. 2. Sasa == === ten: 3 
Ltem 4 @eeeeeeee#ee%e%8tse#es @ Ttem 5 @eee7e7e05edsee¢e8ee7#0¢e8 8 © Ltem 6 
PCr f° Ste ee ee Pen. 6 Se a es eS Item 9 
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Vertical Control 


The text formatted for output must be bounded not only 
on the left and right by the margins of the body, but also by 
the top and the bottom limits of the body. All lines 
formatted in the body are printed with single spacing between 
lines. Commands exist for skipping lines, skipping lines 
between blocks of text, for beginning new paragraphs, for 
beginning new pages, and for conditionally starting at the 
top of a new page. 


NL - New Line 
Format: \NL 
Note: No argument 1s required. 


The "NL" command forces justification of the 
current output line and causes the subsequent 
text to begin at the left margin of the new 
line. | 


If left and right margins are specified, the 
"NL" command is required only at the end of a 
block of text, not at the end of each line. 


Example: 


Input Text: 
\1lm30\rm50\pl 
The new line command is only required at the end 
of a block of text. Normally, lines from the 
input file are automatically formatted by 
boc. \nl 
This is the beginning of a new line.\nl 


Output Text: 
The new line command 
is only required at 
the end of a block of 
text. Normally, 
lines from the input 
file are 
automatically 
formatted by DOC. 
This is the beginning 
of a new line. 
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NE - New Line, Even Margins 
Format: \NE. 
Note: No argument is required. 


The "NE" command forces text of a line to begin 
at the left margin and end at the right margin. 


The proper number of spaces is inserted in the 
formatted line to force the line to the required 
length. 


Note that the "NE" command affects one line and 
is not to be confused with the "EM" commands 
that affects all lines. 


Example: 


Input Text: a 

\lm25\rm55\pl 7 

The new line even margins command is used 
in rare cases where the last line of 

a block of text must be printed with even 
margins as well as the rest of the next.\ne 


Output Text: 
The new line even margins 
command iS used in rare cases 
where the last line of a block 
of text must be printed with 
even margins as well as the 
rest of the text. 


SL - Skip Lines 
Format: \SLnnn 


Where: "nnn" is a number specifying the number of lines 
to be skipped. | 


Note: An error occurs if "nnn" is zero or iS miSSing. 
If the number of lines to be Skipped exceeds 
the number of lines remaining in the body of 
the page, the output text is positioned at 
the top of the following page. 


A command of "\SL1" is the same as a "\NL" 
command. 


The "SL" commana causes execution of the 
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specified skip and beginning of a new line 
for the subsequent text. 


Input Text: 


This is the first line.\sll 
This is the second line.\sl2 
This is the third line.\sl3 
This is the fourth line.\sl4 


Get the point?\nl 


Output Text: 


This is the first line. 
This is the second line. 
This is the third line, 


This is the fourth line. 


Get the point? 


PP - Form Paragraph 


Format: 


Where: 


Note: 


\PP or \pPnnn 


"nnn" is optional and specifies the number of 
lines to be skipped to form a paragraph. 


If "nnn" is zero or iS misSSing, the current 
line is terminated as if a "NL" command is 
encountered. The next line is then indented 
to the column position specified by an "Is" 
command. 


If "nnn" is specified with a value greater than 
zero, the effect is as if a "SL" command is 


encountered. The next line is indented to the 


column position specified by the "IS" command. 


If a "IS" command is not encountered, the 
indentation of the new paragraph is 5 columns, 
the default condition, 
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IS - Number of Spaces for Paragraph Indentation 
Format: \ISnnn 


Where: "nnn" is a number specifying the number of 
columns of indentation for a new paragraph. 


Note: An error occurs if "nnn" is zero or is missing. 


The default value for the "IS" command is 
5 columns, 


PG - Skip to Top of Next Page 
Format: \PG 
Note: No argument is required. 


Normally, pages are filled so that the body 
contains aS much text as possible. 

However, if the user wishes not to fill the 
entire page, but ‘to force the beginning of 
new text to the top of the next page, the 
"PG" command is used. 


The "PG" command is useful at such times 

when the body does not have enough remaining 
lines to accommodate an entire list or table, 
or if only one or two lines of a new paragraph 
can be accommodated. 


PS - Conditional Skip to Top of Next Page 
Format: \PSnnn | 
Where: "nnn" is a number specifying the number of lines 


that must remain in the body for subsequent 
lines to still fit on the current page. 


Note: If fewer than "nnn" lines remain in the body, 
anew page is formed as if a "PG" command is 
encountered. 


An error occurs if "nnn" is zero or iS misSing. 
The "PS" command is used to ensure that tables, 


lists, or diagrams (items that have fixed 
lengths) are not split between two pages. 
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Line Justification 


Lines of text in the body can be justified between left 
and right margins by one of the following modes: 


left justification 
right justification 
centering 

even margins 


LJ - Left Justify Text 
Format: \LJd 
Note: No argument is required. 


Regardless of the input text, the output 
text has the first character of each line of 
text in the column of the left margin. 


The right margin is ragged, depending on the 
number of words that can fit on each line. 


If no line justification command is 
encountered, the default justification is 
left justification. 


The left justification mode remains in effect 
until another line justification mode is 
encountered, 


Example: 


Input Text: 

\135 

\lm25\rm55\pl1 

Learning to use DOC is like learning 
a new language. Practice is the 

key to success. Once the basics 

are learned, then practice permits 

the user to make everwidening use of 
the DOC command set. 


Output Text: 

| Learning to use DOC is like 
learning a new language. 
Practice is the key to success. 
Once the basics are learned, 
then practice permits the user 
to make everwidening use of the 
DOC command set. 
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RJ - Right Justify Text 


Format: 


Notes: 


\RJ 


No argument is required. 


Regardless of the input text, the output text 
has the last character of each line of text in 
the column of the right margin. ) 


The left margin is ragged, depending on the 
number of words that can fit on each line. 


The right justification mode remains in effect 
until another line justification mode command 
is encountered. 7 


If any parts of a line are formatted with tabbed 
text, only the text to the right of the tabbed 
text 1S right justified. Text to the left of 
the tabbed text is not justified. _ 


Example: Using the same example of input text as for 


the "LJ" command, but replacing the "LJ" 
command with a "RJ" command, the following is 
obtained: a 4 ae 


Output Text: 


Learning to use DOC is like 
| -learning a new language. 
Practice is the key to success. 

Once the baSics are learned, 
then practice permits the user 
to make everwidening use of the 
DOC command set. 


Input Text: 


\lm25\rm55\pl 

\rj 7 
xxxx \tb40 yyyy\nl 
xxx \tb40 yyy\nl 
xx \tb40 yy\nl 

x \tb40 y \nl 

xx \tb40 yy \nl 
xxx \tb40 yyy\nl 


 XXXX \tb40 yyyy\nl 
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Output Text: 


XXXX VVVY 
XXX YVV 
XX VY 
X y 
XX VY 
XXX VYVY 
XXXX YYVYY 


CN - Center Subsequent Text 
Format: \CN 
Note: No argument is required. 


When the "CN" command is encountered, output 
text is poSitioned so that it lies evenly 
between left and right margins. 


The "CN" command is useful for centering such 
items as chapter headings, table titles, and 
list titles. 


The centering mode remains in effect until a 
new line justification mode command is | 
encountered. End the current line with a "NL" 
or Similar command before giving a new line a 
Justification command. 


Example: Using the same example of input text as for the 
"LJ" command, but replacing the "LJ" command 
with a "CN" command, the following is obtained: 


Output Text: 


Learning to use DOC is like 
learning a new language. 
Practice is the key to success. 
Once the baSics are learned, 
then practice permits the user 
to make everwidening use of the 
DOC command set. 
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Em - Form Even Margins 
Format: \EM 
Note: No argument is required, 


If an "EM" command is encountered, even left 
and right margins are obtained. 


Even margins. are obtained by distribution of 
Spaces between words in aline. Every other 
line has spaces inserted from left to right. 
The remaining lines have spaces inserted from 
right to left. This space distribution avoids 
giving the text a uneven appearance, ensuring 
a uniform appearance. 


Example: Using the same example of input text as for 
the "LJ" command, but replacing the "LJ" | 
command with an "EM" command, the following is 
obtained: | 


Output Text: 


Learning to use DOC is like 

learning a new language. 

Practice is the key to success. 

Once the basics are learned, 

then practice permits the user 
to make everwidening use of the 

DOC command set. 
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Sometimes it is easier to format a specific table or 
section of a document manually with the EDITOR than it would 
be to add the necessary DOC commands to arrive at the same 
format. The "as-is" command allows the suppression of DOC 
formatting insofar as word spacing, line spacing, and line 
justification are concerned. The text is still formatted so 
that the limits of left and right margin and body size are 
maintained. There are two commands for specifying the extent 
of "as-is" text. 


AS - Begin Subsequent Text As-Is 
Format: \AS 
Note: No argument is required. 


All text that follows the "AS" command is 
treated as "as-is" text. 


The "AS" command remains in effect until a 
"//" command is encountered. 


Any DOC commands following the "AS" command 
are treated as text and are not executed when 
the DOC processor is invoked. 


The "AS" command is useful when items such as 
diagrams are to be inserted into the text. 
‘DOC commands then have no affect and diagrams 
are not distorted. 


Margin commands given before the "AS" command 
is encountered are not suppressed. Text 
following the "AS" command is printed between 
the left and right margins of the body. 


If left and right margins are set so that 
"as-is" text is longer than the distance 
between margins, each overly long line of text 
is truncated. The truncated text is placed on 
the next line, beginning at the left margin. 


All commands in effect before the "AS" command 
1S encountered are reinstated. after the we ai 
command is given. 


Refer to the "//" command for an example of 
"as-is" text. 
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// - End As-Is Text 


As-Is Text Commands 


Format: \// 

Note: No argument is required. 
The "//" command must be the first command on 
an input line. It must precede any other DOC 
command. — | 
The input text following the "//" command is 
then formatted according to the DOC commands 
that were in effect before the "AS" command 
was given. 
The "//" command is ignored if a previous "AS" 
command was not given. 

Example: 


Input Text: 
\as 


a ane we ee taeke Gree Ce Ene GED GOS Ge Ge Cie Me GO! GFW GEM? (eG Ger) dine GEE SAD GEN GEE GON Gee Gee GED ene Gre Gee ee GU Gee Gene MK GE Geet one 


re CD jn ey ee Me GF Te ee He EES Ge? Ge tee Er GE Gt Gees Gee Ee GES Ge EE GEE eee et GEE Ge GEE GURY eee me Gin! aes Ge een GND Gee Gree Que 
e ® e eo s e ° 
e 6 e e e CJ eo6¢¢@ @ @ 
® 
eeoeee%ee?@?e2e8 @ 6 
@ 
®©*@ee¢eese#euees2rfoee#e##8¢e%e%e6@e @ 
@ e @ _ @ 
e @ e eoeoeeee#e#eoe%e##8e#@ee?e?eeee¢e##@¢ @# @ 
e 
eeoe#e#%eeeee##¢¢«?ee8e8ememmemmcemUCcCOmUlCOOlUlCcFmhC WC OU OhmhUc hUChUO 
e 
e eooeeoeec4ecee#eeegéees#s#eee#eee#®?##e#?@t088e800880 080 @€ 6 & @ 
~ F 
o@#@@eeeee?#2e#¢ee¢e?8ke8f@e¢e#2c¢0880@6¢80 @ @ @ @ 
eoeeee%eeete#@*® 


Py : 
eeoee#eeee#ee#8e¢€e8e¢ee8e## @@ e808 &@& @ 86 8@hU8HhhUOhUCOUCUMMUCUHMUMCU 


\// 


Output Text: 


ae Canin Ge Ge Te Ge Geere Wed Gre Ge GRNOT GR Ge URE GE? Gi Gen Ee ES me HIRE Gre ERR BERET EUR EE GRO GUE GEER Geen que GEOR Ges Ge fae Ge YY Ge GED Gn 


me OD ae WR Ge GO Ge He Ga fre Ge Ce Gee GD Che Ge GE Gene ee ET Ge Gees Ee Ge Glee GuRPt Ge GE qnEeP mew Gee Gm qe gee Gl GE Ge me ee 


e ‘ 
ooo eoeo#ee3e85eeggce%#e@#e#8e#8+%t@¢@% 6 @ 
e 
oeeee#e7eee#e#e#e8e#e#ee8fe¢e8¢ 0 8@ 8 8& @ 6 @ 
e . 
oeeoe7e34e«5oneee3q7e&ecoeee#egoeoeevee#sx31n4ee#eeeeegeee# @ 
- ‘ 
oe#e@esn5ee@ee#e#ee@eeeveoe%e#e#e#eere@e#ee@ee#e#?e @®¢00808006806hmUOMUOMUUCUCOMUCUSMUHhLUC OhU HhU MhUOH 


e . 
ooeoeee#e#ee3e#$3¢esv#s#ese#Hes#4ege08sex#s#ee08ckee#e#et8$e@eetee7#nereoe3e#eeeemhmUmethmlUOmUClUCOmUClUcPUlUchrCmhUCUCc OhlUhHmhlU Hh 
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sBLt 
JB 
~Bit 
sBLE 
oie 
eDLe 
~Bit 
<BLt 


sBit 
~Bit 
owls 
spat 
eBit 
~Bit 


eBit- 


ebac 


Zero 
one 
Cwo 
three 


four 
five 


Six 
seven 


ZeLO 
one 
two 
three 
four 
five 
Six 
seven 
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CHAPTER 6. INPUT/OUTPUT CONTROL COMMANDS 


Normally, when DOC is first started up, the default 
input device is the console keyboard, and the default output 
device is the printer. Commands exist for reasSigning either 
the input or the output device. These commands, as well as 
some miscellaneous commands related to input/output 
functions, are described in this chapter. 


The DOC input/output commands are: 


Command Function 

KY Switch input stream to console keyboard 

TY Switch ouput stream to console typewriter 

LP Switch output stream to line printer 

QP Switch output stream to text quality printer 

OS Return control to CODOS, terminating DOC 

CM Set printing mode to continuous (default) 

NC Set printing mode to non-continuous 

Fi Assign diskette file to logical input file i 
(i = 1-3) 

Di Switch input stream to logical input file i 
(1 = 1-3) 

Ri Rewind logical input file i (i = 1-3) 

Al Print or display logical input file i 
(i = 1-3) 

FR Return input stream to logical input file 

* x Display comment on console 

PR Restart printing at specified page number 


NOTE: The alphabetic characters used in DOC commands 
may be in either upper or lower case. 

KY - Switch Input Stream to Console Keyboard 

Format: \KY 

Note: No argument 1S required. 


The "KY" command specifies that the console 
keyboard is to be the input device. 


An input prompt, "?" displays when the "KY" 
command is encountered. ~ 7 


Usually, the "KY" command is given from one 
of the diskettes installed in the drive unit, 
permitting the insertion of a name, address, 
date, etc., at an appropriate place in the 
input text. 
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After the response to an input prompt, control 
usually returns to the line printer by means of 
the "LP" or "QP" command. 
When DOC is invoked, the default input device 
is the console keyboard, indicated by the 
display of the input prompt "?." 
WARNING: When using CHAIN file processing (see CODOS 
manual), the "KY" prompt cannot be used for operator 
communications. 
TY - Switch Output Stream to Console Typewriter 
Format: \TY 
Note: No argument is required. 


The "TY" command specifies that the console 
typewriter or display is to be the output device. 


When DOC is invoked, the default output 
device is the console typewriter or display. 
LP - Switch Output Stream to Line Printer 
Format: \LP 
Note: No argument is required. 
The "LP" command specifies that the output 
device is to be the line printer. 
QP - Switch Output Stream to Text Quality Printer 
Format: \QP 
Note: No argument is required. 


The "QP" command specifies that the output 
device is to be the Text Quality Printer (SP5). 
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OS - Return Control to CODOS, Terminating DOC 

Format: \OS 

Note: No argument is required. 
When the "OS" command is encountered, the 
table of contents file closes if open. The 
last page on the printer ejects, and control 
returns to CODOS. 
The "OS" command is used to terminate the DOC 
processor, 

CM - Set Printing Mode to Continuous 

Format: \CM 

Note: No argument is required. 
The continuous printing mode is the default 
mode for all printing. 

NC - Set Printing Mode to Non-Continuous 

Format: \NC 

Note: No argument is required. 
The non-continuous mode allows the printing 


of one page at a time. This command is used 
when printing on letterhead or special size 


paper. | 
Fi - AsSign Diskette File to Logical Input File i 
Format: \F]l filename 

\F2 filename 

\F3 filename 


Where: "filename" is in a standard file specification 
format as follows: 


<filename> [.<suffix>] [:<logical unit number>] 


Note: The default values are "SA" for suffix and "0" 
for the logical unit number. 
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The "Fl" command asSSigns a specified file (by 
way of its filename) to logical input file l. 
The "F2" command aSSigns a specified file to 
logical input file 2, and the "F3" command 
assigns a specified file to logical input file 
Bs 


The "Fi" commands open specified files and 
cause previously specified files to be closed, 


If filenames are not specified, file command 
errors occur. 


The current input device is not affected by 
the encounter of a "Fi" command. 


An error occurs if a specified file is not in 
the correct format. 


Di - Switch Input Stream to Logical Input File i 


Format: \D1 
\D2 
\D3 


Note: No argument is required. 


Once a file is defined, either with DOC 
invoking command or with an "Fi" command, the 
input stream can be switched with a "Di" 
command so that it comes fron one of the 
logical input files. 


The effect of a "Di" command is to terminate 
the fetching of text from the current input 
device. All subsequent text is fetched from a 
Specified logical input file until another "Di" 
or “end-of-file" condition is encountered. 


When an "“end-of-file" condition is encountered, 
the console keyboard becomes the input device 
and default conditions are restored. 


An error occurs if a diskette file is not 
assigned to the logical input file that the 
"Di" command specifies. 


The "D1" command switches to logical input file 
1. The "D2" command switches to logical input 
file 2; and the "D3" command switches to logical 
INput: File: 3 
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Ri - Rewind Logical Input File i 


Format: \R1 
\R2 
\R3 


Note: No argument 1S required. 


"Ri" commands rewind logical input files 
so that they can be reused without the need 
to reaSSsign them by file name. 


The effect of a "Ri" command is to position 
the specified logical input file's pointer 
to the beginning of the file. 


An error occurs if the diskette file has 
not been assigned to the specified logical 
input file by way of a "Fi" command. 


The "Rl" command rewinds logical input file l. 
"R2" command rewinds logical input file 2. 
"R3" command rewinds logical input file 3. 


Ai - Print or Display Logical Input File i As-Is 


Format: \Al 
\A2 
\A3 


Note: No argument is required. 


"Ai" commands permit processing logical input 
files as-is, i.e., with EDITOR and DOC 
commands in place. 


An "Ai" command causes input from a specified 
logical input file to print or display as-is 
until an "end-of-file" condition is met. The 
input device is then switched back to the 
console keyboard with the "KY" command. 


An error occurs if a diskette file has not 


been assigned to a specified logical input 
file by an "Fi" command. 
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FR ~ Return Input Stream to Logical Input File 


Format: 


Note: 


\FR 
No argument is required. 


The "FR" command permits return of the input 
stream to the last logical input file requesting 
input from the console Piney One? by a "Ky". 
command . 


A "Di" command could be used, but with the "FR" 
command, the user does not have to remember 
which of the three logical input files is to Pe 
reasSigned to the input stream. 


** — Display Comment on Console 


Formats: 


Where: 


Note: 


\*¥ text | 


"text" is any comment the user wishes to 
display. | 


The text is terminated by a carriage return. 


The "**" command causes the text to be 
displayed. Thus, messages in a logical input 


file can be directed to the user. These 


messages can be directions as to what input 
is to be supplied, or they can apply to 
monitoring information. 


PR - Restart Printing at Specified Page Number 


Format: 
where: 


Note: 


ERR 
"xXEXK" specifies the beaianina:. page number. 


The "PR" command Sermeee partial printing of 
a file or reprinting of a portion of the file 
beginning somewhere else other than on the 
first page. | 


The page number "xxxxx" must be exactly five 
charaters in length, followed by a "\" sign 
Or a carriage return. The fifth character 
cannot be a "\" Sign or a carriage return, 


The use of the "PR" command is restricted 
to documents with page numbers. 
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If page number "xxxxx" iS never encountered, 
printing does not take place. 


Multiple File Processing 


There may be times when, instead of procesSing and 
printing a series of files individually, it is desirable to 
link the files in order to process and print them as a single 
document. For example, if a series of input files have been 
prepared, each representing a chapter of a book, the user may 
wish to link them in order to obtain a printed book. : 


To prepare the files for linking, each input file must 
contain a "PG" command on itS initial page. This forces the 
beginning of the file on a new page. A "D1" command at the 
end of the file is needed to switch back to logical input 
file 1. The end of the input file should also contain . 
Suppression commands (in front of the "D1" command) for 
heading and footing text and page numbers. This prevents the 
possibility of carrying over these numbers into the next 
linked file. Be sure that a new page (PG) command is 
inserted before the suppresion commands in order to prevent 
the deletion of the footing on the last page of text. 


Linking is accomplished by creating a new file, referred 
to aS a "driver" file. The filenames of the files to be 
linked, are entered along with file specification and 
Switching commands. For example, the following input files 
exist, and the user wishes to link them to obtain a printed 
book. 


CHAPTERI 
CHAPTER2 
CHAPTER3 
CHAPTER4 


The "driver" file is created in the EDITOR with a 
filename of "Book." | | 


=EDIT BOOK 


The files are entered into "Book" with file specifications of 
"F2" and file switching of "D2." The "driver" file then 
appears as follows: | 


\£2CHAPTERI \d2 
\£2CHAPTER2\d2 
\£2CHAPTER3 \d2 
\£2CHAPTER4\d2 
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The book is then suowewecd and eee’ by invoking DOC as 
follows: 


-=D0C BOOK 
?\dl 
?\lp 


Each of the parts of the book is then reached via 
logical input file 2. When the "\D1" command executes in the 
chapter files, control returns to the "driver" file which 
invokes the next part to be printed. As. long as the file 
Switching commands are used, the format control conditions 
remain unchanged when control passes from one file to 
another. Only when an "end-of-file" condition is detected 
will the initial DOC default values be restored. 


If a table of contents file exists with a filename of 
"CONTENTS," and the user wishes that file to be part of the 
printed book, the "driver" file then appears as follows: 


\£2 CONTENTS \d2 
\f 2CHAPTER1\d2 
\ £2CHAPTER2\d2 
\f2CHAPTER3\d2 | 
\£2CHAPTER4\d2 ~ 


Refer to Chapter 7 for details on creating a table of 
contents file, 


File Recursion 


File recursion simply means to repeat a process. It 1s 
used when you have a form letter that's sent each time to a 
different address. DOC eliminates the need to manually type 
the letter each time it's used. All of this is done through 
the use of the file switching and file rewinding commands 
(see Di and Ri commands in this same chapter). 


For example, a user has a rough draft of a letter. This 
letter is going to about 100 people. The user inputs the 
letter with all the necessary DOC commands. However, in the 
places where the name and address is to appear, the DOC 
command "\d2" is placed. "D2" tells the computer that the 
name and address is contained in logical input file 2. File 2 
is an address list file already stored on disk. The letter 
Just inputed is logical input file 1. The letter and address 
files are specified as logical input files : and 2 with the 
"Fi" command. 


For example, if logical input file 1 contains a form > 
letter (LETTER), and logical input file 2 contains names and 
addresses (ADDRESS), then the following input 1S required to 
invoke DOC and print multiple copies of the form letter. 
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Note: CODOS prompts the operator with "="; DOC prompts the 
operator with "?," 


=DOC LETTER, ADDRESS 
?\dl 


The format of the "LETTER" file may be represented by 
the following. The sequence of periods (...) indicates text 
in the file. "Name" and "Address" are to be supplied by the 
"ADDRESS" file. 


text....\d2 (Name) text....\d2 (Address)....\pg\rl\dl\nc 


The format of the "ADDRESS" file may be represented by 
the following: 


Name 1 \dl Address 1 \dl 

Name 2 \dl Address 2 \dl 

Name 3 \dl Address 3 \dl 
Etc. 


The "LETTER" file calls the "ADDRESS" file for two 
inputs per page. The first call is for the name. The second 
call is for the address. After the body of the letter 
prints, a “"\pg" command ejects the page. The "LETTER" file 
then rewinds itSelf (\rl) and returns control to itself at 
the beginning (\dl). If the letter is printed on a 
non-continuous form (i.e., letterhead), the "\nc" command is 
used to allow the printing of one page at a time. 


This process repeats until an “end-of-file" condition is 
detected in the "ADDRESS" file. Since the "ADDRESS" file is 
not rewound, the operator inputs the new names and addresses 
for each copy of the letter that prints. Appendix C contains 
a detailed example of this process. 


DOC User's Guide | Page 6-09 


CHAPTER 7. TABLE OF CONTENTS COMMAND 


For large manuals, a table of contents is essential to 
the overall usefulness of the document. DOC provides the 
facility for the automatic generation of a table of contents 
file. Once the table of contents file is built, it can be 
incorporated into the normal sequence of printing that 
produces the completed document. Alternatively, the table of 
contents file can be printed separately and inserted in the 
front of the finished document. 


In order to take advantage of the table of contents 
feature, the user must have an understanding of the DOC 
commands described in the previous chapters, especially the 
input/output control commands in Chapter 6. 


The table of contents file is referred to as logical 
file "0." Unlike the other file commands described in the 
previous chapter, the table of contents file command creates 
an output file. 


The DOC table of contents file commands are as follows: 


Command Function 

FO filename Open table of contents file 

CO Close table of contents file 
BEnnn text Enter in table of contents file 
P0Qas-is text Insert as-is text to format table 


of contents file 


NOTE: Similarity between the zero (0) and the letter 0, 
could confuse the user and lead to the misspelling of the 
above commands. The zero is the correct character to use. 


FO - Open Table of Contents File 

Format: \FO filename 

Where: "filename" is in standard file specification 
format as follows: 
<filename>[.<suffix>][:<logical unit number>] 

Note: To open a table of contents file, the DOC 
command must be given naming the file to be 
scanned, followed by the "FO" command. 
It is recommended that the filename used with 
the "FO" command should be something like "TOC" 


Or "CONTENTS" in order that it not be confused 
With other DOC commands. : 
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NOTE: 


Table of Contents Command 


The filename must not exceed eight characters. 
Its first character must be alphabetic, and 
it must be an upper case letter. | 


If not given, the value of the suffix defaults 
to "SA." The default value for the logical 
unit number is zero. 


If the "FO" command is not given, all other 
table of contents file commands are ignored. 


Refer to "Creating a Table of Contents" in this 
chapter. 


For the "FO" command, the zero (0) is the correct 
character to use, | | 


CO -—- Close Table of Contents File 


Format: 


Note: 


NOTE: 


\C0 
No argument is required. 


The "CO" command closes the table of contents 
File. Refer to "Creating a Table of Contents" 
in this chapter. 


After the "CO" command is given, all een 
table of contents file commands are ignored. 


If a "CO" command is not given to close the 
table of contents file, the file is closed 
automatically when control is returned to 
CODOS. It is recommended that the "CQ" 
command always be used to close a table of 
contents file. 


For the "CO" command, the zero (0) 1s tne ‘correct 
character to use. | 
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BE - Begin Table of Contents Entry 


Format: 


Where: 


Note: 


\BEnnn text 


"nnn" is a number specifying one of the 
logical sequence of tab stops set up by the 
"FO" command. 


"text" is normally a chapter or section 
heading selected as a table of contents entry. 


The "BE" command, placed before text in the 
input text file, results in a table of contents 
entry when the "FO" command is encountered. 


Text is terminated by a carriage return or "\" 
Sign. "\" signs should not be used in the text. 


An error occurs if "nnn" is not a logical tab 
stop, or if it is missing. 


Refer to "Creating a Table of Contents" in this 
chapter. | 


PO - Insert As-Is Text to Format Table of Contents 


Format: 


Where: 


Note: 


Example: 


\POas-is text 


"as-is text," entered into the input file, 
formats information for the table of contents 
file. 


The "PO" command is normally used to insert 
formatted information in the input file to 
affect the table of contents file. Items 
such as heading and footing text and roman 
numeral page numbers, not automatically 
supplied when the "FO" command is encountered, 
can be inserted with the "PO" command. 


The “as-is text" is terminated by a carriage 
return. 


Refer to "Creating a Table of Contents" in | 
this chapter, | | 


The entry into the input file of: 
\PO\BF User's Guide \RN2 
would, when a "FO" command is encountered, Cause | 


"User's Guide" to appear in the footing in the 


table of contents, and page numbers would be 
roman numerals, beginning with "ii." 
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NOTE: For the "PO" command, the zero (0) is the correct 
character to use. . 


Creating a Table of Contents 


When "BE" and "PO" commands are placed into an input 
file, a table of contents file (an output file) is created 
automatically when a "FO" command follows the DOC command. 
The "BE" command selects the chapter and section headings for 
entry into the table of contents. The "PO" command supplies 
the text for the table of contents file. 


When the "FO" command is encountered, a table of 
contents file is opened with logical file zero assigned. 
Left and right margins of columns 10 and 70, respectively, 
are set. Sixteen tab stops are set between margins, for each 
page of the file. The width of each tab is four columns, 
thus providing fifteen tabs. 


The "BE" command has a format of "\BEnnn text," where 
"nnn" is a number representing one of the logical tab stops. 
The larger the number, the the greater is the indentation of 
the text from the left margin. That is, a command of "\BEI1 
text" begins the text in column 10, a command of "\BE2 text" 
begins the text in column 14, and so on. 3 


In addition, the "FO" command causes the heading, "TABLE 
OF CONTENTS," to be inserted at the top of each page of the 
table of contents file. It also causes the word "Page" to be 
inserted above the columns where page numbers for the entries 
are to be placed. 


The input text is then scanned for "BE" and "PQ" 
commands. When a "BE" command is found, the text is inserted 
in the table of contents file as an entry. The page number 
of the input file where the text is located, is inserted in 
the page number columns of the table of contents file. A 
filler, consisting of the leader characters, space and 
period, is inserted between the text entry and the page 
number. When a "PO" command is found, the specified format 
is carried out. When a page is filled, a page command forces 
continuation of the table of contents to a new page. 


When a "CO" command is encountered, the heading, "TABLE 
OF CONTENTS," is suppressed, all tab stops are cleared, and 
insertion of page numbers is ended. Continuation of the 
input file processing is to a new page, and control is 
returned to logical input file l. 7 


The following example illustrates the embedding of "BE" 
and "PO" commands in the input text. Lines with periods 
represent intervening text between headings in the input 
file. It is important to note that when a "nl" command is 
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given with the "be" or "pod" commands, DOC incorporates them 
in the table of contents and also in the text of the document 
itself. Thus the command: 


\be 1.0 INTRODUCTION\n1 
\po\n1 


instructs DOC to skip 2 lines in the table of contents as 
well as in the document. 


NOTE: For the "FO," "CO," and "PO" commands, the zero (0) is 
the proper character to use. 


Input text: 
\bel 1.0 INTRODUCTION\n1 


\po\nl 
\be2 1.1 System Configuration\nl 


\be2 1.2 DOC Features\nl 


\be2 1.3 General Concepts\nl 


\be3 1.3.1 DOC command format\nl 
\be3 1.3.2 Format Assumptions \nl 


\be3 1.3.3 Spaces and Punctuation\nl 


\be2 1.4 Invoking the DOC Processor\nl 
\be3 1.4.1 Multiple Copies\nl 


\p0\n1 


The following illustrates the portion of the table of 
contents file, discussed above, created when a "FO" command 
is encountered. 


Output Text: 
TABLE OF CONTENTS | Page 


a 


1.0 INTRODUCTION .....2-. ese eee we eees 


1.1 System Configuration .... 
1.2 DOC Features .....e.-. 
1.3 General Concepts ...... 
1.3.1 DOC command format . 
1.3.2 Format Assumptions. . 
1.3.3 Spaces and Punctuation 
1.4 Invoking the DOC Processor .. 
1.4.1 Multiple Copies ....  . 


© © @ 6 e 
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A table of contents file can be created for either a 
Single file or for multiple files. For a single file, it is 
a matter of giving the DOC command and naming the input file. 
A "FO" command is given, naming the table of contents file. 
DOC then creates the table of contents file, with the 
processing visible on the display screen. When the 
processing stops, the "CO" command is given to close the 
table of contents file. For example, given the file, 
"MANUAL," a table of contents file, "CONTENTS," is created as 
follows: 


=DOC MANUAL 

?\FOCONTENTS\D1 

(processing now takes place) 
2?\CO0 


For multiple files, a table of contents file can be 
created, treating the files individually or collectively (as 
a linked file). Using the example of treating files 
individually, the files must be specified with "Fi" commands 
and switched with "Di" commands. For example, the following 
files exist for which a table of contents is to be obtained: 


CHAPTERL 
CHAPTER2 
CHAPTER3 
CHAPTER4 


The following sequence of commands can be used: 


=DpOoC =DOC CHAPTERI 

?\FOCONTENTS ?\FOCONTENTS\D1 

?\FLCHAPTERI1\D1 | _ ?\FLCHAPTER2\D1 

@®eeoeee@ee?#?@e%e#¢e86¢e?@e@ OR #eee3e30ee%?ee#ee¢?080 @ 

?\F1CHAPTER2\D1 | ?\F1CHAPTER3\D1 

?\F1CHAPTER3\D1 ?\F1CHAPTER4\D1 
 ?\FLCHAPTER4\D1 «2X0 

re eae ee a . ?\F1CONTENTS\QP 

?\CO0 ?\D1 
 ?\FLICONTENTS\QP (file prints) 

?\D1 —  ?\0S — 

(file prints) 

?\0S 


The first file is designated logical input file 1. The 
"FO" command is given to scan the first file and processing 
takes place (represented by the dotted line). When the first 
file finishes processing, the user specifies the second file 
as logical input file 1 and switches input to the secona 
file. The second file is then processed. Files are 
Specified and inputs switched until all files are processed, 
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The "CO" command closes the table of contents file. The 
Operator can then instruct DOC to print the table of contents 
file. The "OS" command returns control to CODOS. 


Multiple files can be treated as a Single file when 
input files are linked as described under, "Multiple File 
Processing," Chapter 6. For example, given the linked file 
"BOOK," a table of contents file can be created for “BOOK." 


=DOC 

\FOCONTENTS\D1 

(processing now takes place) 
?\FLCONTENTS \QP 

(the table of contents prints) 
?\CO0 

?\0S 


The table of contents should only be created when the 
manuscript is in its final form. If there are any changes to 
the manuscript that would affect the table of contents (1.¢e., 
resequencing of page numbers), a new table of contents file 
must be created uSing the same process aS with the first. If 
there are just changes to the table of contents file itself, 
the user may invoke the EDITOR to make the changes. For 
example: 


=EDIT CONTENTS 


The changes can now be made to the table of contents file. 
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Messages 


The following messages can be generated with the use of 
DOC commands. 


DOCUMENT PROCESSOR V.R 


This message displays as a sign-on message by 

the DOC command program. The letters "V" and "R" 
reflect the current version and revision numbers 
of DOC. 


This is the input prompt that displays each 
time the input stream switches to the console 
keyboard. Initially, the keyboard is the 
input stream. Thus, the input prompt immediately 
follows the sign-on message. It is through 
console input that the operator gives commands 
to the DOC processor for asSigning files, 
Switching input and output streams, setting up 
initial conditions other than the default 
conditions, or for supplying additional text 
for the formatted document. 


INVALID NUMBER OF COPIES 


This message indicates that the parameter 
following the semicolon on the command line, 
invoking DOC iS non-numeric or has a value of 
Zero. 


CANNOT USE MULTIPLE COPIES AND MULTIPLE FILE SPECIFICATIONS 


This message indicates that the multiple a 
option was requested on the command line 

invoking DOC, and that more than one file name 
was entered. Only a Single file can be used with 
the multiple copies option. That file must be 
rE de 1g 


** COMMAND ERROR -~xx-- 


This message indicates that a DOC command 
(specified by the string "xx" in the message) 
is invalid and cannot be processed. Command 
errors can occur for a variety of reasons. 
The two most common reasons are a mistyped 
command and an invalid or misSing command 
argument. 
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PRINTED BY DOCUMENT PROCESSOR V.R 


This message prints at the top of the last 
page of a document. The presence of this 
message indicates that DOC read all input files 
until their "“end-of-file" was encountered. 


Command Errors 


The two main reasons for command errors are mistyped DOC 
commands and missing or invalid command arguments. The 
following list contains those DOC commands that can cause an 
error if used incorrectly. The special notation used in the 
descriptions is: 


Symbol Meaning 

nnn A number ; T=3 Gigs, 

XX A two-character string. 

XXXXX A five-character string. 

L.S2u A standard CODOS file name dena ientaon, 


Command Cause of Error 


Al Logical file 1 is not open. 


A2 Logical file 2 is not open. 
A3 Logical file 3 1s not open. 
ALnnn The number "nnn" is misSing, not in the range 


1-132, or greater than the current value of 
the absolute right margin. 7 


ARnnn The number "nnn" is missing, not in the range 
1-132, or less than the current value of the 
absolute left margin. 


BEnnn The number "nnn" is misSing, not in the range 
1-16 (assuming standard table of contents tab 
stops), or refers to an undefined tab stop. 


BLnnn The number "nnn" is missing or has a value of 
zero, | 

Di Logical file 1 is not open. 

D2 Logical file 2 is not open. 

D3 Logical file 3 is not open. 
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FOf£.S:u 


Flf.ssu 
F2f£.S:u 
F3£.Ss:u 
Finnn 
FR 
HiEnnn 


ISnnn 


LDxx 


LMnnn 


LTnnn 


PBXXXXX 


PBXXXXX 


PSnnn 
PTXXXXX 


RL 


DOC User's Guide 


Command Errors 


The table of contents file already exists 
and is either write protected or of the 
wrong format. 


The file specified does not exist or is 
of the wrong format. 


The file specified does not exist or is 


of the wrong format. 


The file specified does not exist or is 
of the wrong format. 


The number "nnn" iS missing. 


The keyboard input stream was never 
given control from one of the three logical 


input files. 
The number "nnn" is missing. 


The number "nnn" iS misSing or has a value 
of zero. 


The leader characters "xx" were not exactly 
two characters. That is, a reverse slash 
Sign or carriage return was encountered as 
either the first or the second character. 


The number “nnn" is misSing, not in the 
range 1-132, or greater than the current 
value of the right margin. 


The number "nnn" is missing, not in the 
range 1-20, refers to an undefined tab 

stop, or the column associated with the 
Specified tab stop is greater than the 

current value of the right margin. 


The page number string "xxxxx" is mbeeaNg 
Or is Shorter than five characters. 


The page number string "xxxxx" for 
restarting is misSing or is shorter than 
five characters. 


The number "nnn" is misSing or has a 
value of zero. 


The page number string "xxxxx" is missing 
Or is Shorter than five characters. 


Logical file 1 is not open. 
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R2 Logical file 2 is not open. 
R3 7 Logical file 3 is not open, 
RMnnn The number "nnn" is misSing, not in the 


range 1-132, or is less than the current 
value of the left margin. 


RNnnn The number "nnn" is not in the range 0-20. 


RTnnn The number "nnn" is missing, not in the 
range 1-20, refers to an undefined tab 
stop, or the column associated with the 
specified tab stop is less than the 
current value of the left margin. 


SLnnn The number "nnn" is miSSing or has a 
value of zero. 


SPnnn- The number "nnn" is missing or is not in 
the range 1-132. | 


TBnnn The number "nnn" is misSing or not in 
the range 1-132. 


TFnnn = The number "nnn" is missing, not in the 
range 1-20, refers to an undefined tab 
stop, or the column number associated 
with the specified tab stop is less than 
the current column position. 


TSnnn The number "nnn" iS misSing, not in the 
range 1-132, or 20 tab stops have already 
been defined. | 


TTnnn The number "nnn" is missing, not in the 
range 1-20, or refers to an undefined tab 
Stop. 
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This appendix lists the DOC command set alphabetically 


and by category. 


Command Alphabetic Listing 


Command Function 

Al Print disk file i as-is (1 = 1 to 3). 

AL Set absolute left margin for page numbers 

AR Set absolute right margin for page numbers 

AS Begin subsequent text as-is 

BE Begin table of contents file entry 

BF Begin footing text 

BH Begin heading text 

BL Specify body length 

C0 Close table of contents file 

CN Center subsequent text 

CM Set printing mode to continuous (default) 

Di Switch input stream to diskette file i 
(1 = 1 to 3) 

EM Form even margins 

FO Open table of contents file 

Fi Define diskette file i (1 = 1 to 3) 

FL Specify footing length 

FR Return input stream to logical input 

HL Specify heading length 

IS Specify spaces in paragraph indentation 

KY Switch input stream to console keyboard 

LD Define leader characters 

LJ Left justify text 

LM Set left margin 

LP Switch output stream to line printer 

LT Set left margin to logical tab stop 

NC . Set printing mode to non-continuous 

NE New line, even margins 

NL New line 

OP Optional "Page," print only numbers 

OS Return control to CODOS 

PO Insert as-is text in table of contents 
file 

PB Position page numbers at bottom of page 

PE Page numbers end on this page 

PG . Skip to top of next page 

PL Purge current output line 

PP Form paragraph 

PR Restart printing at specified page 

PS Conditional skip to top of next page 

PT Position page numbers at top of page 


DOC User's Guide Page 


A-O1 


Appendix A 


QP Switch output stream to text quality printer | 
Ri Rewind diskette file i (i = 1 to 3) 7 
RJ Right justify text | 

RN Use roman numeral page numbers 

RM Set right margin 

RP Resume printing of "Page" 

RT Set right margin to logical tab stop 

SL Skip lines | | 

SP Insert spaces in line 

TB Tab to absolute column 

TC Clear tab stops 

TF Tab with filler 

TS Set tab stop 

TT Tab to logical tab stop 

TY Switch output stream to console typewriter 
// End as-is text 

*K* 


Display comment on console 
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Page Format Commands 


Command Function 

HL Specify heading length 

BH Begin heading text 

BL Specify body length 

FL ~Specify footing length 

BF Begin footing text | 

AL Set absolute left margin for page numbers 

AR Set absolute right margin for page numbers 

PT Position page numbers at top of page 

PB Position page numbers at bottom of page 

PE Page numbers end on this page 

RN Use roman numeral page numbers 

OP Print only page numbers, delete "Page" 
Resume printing of word "Page" 
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Command Alphabetic Listing 


Page 


or 2* ? 


3-02 
3-03 
3-03 
3-04 
3-05. 
3-05 
3-07 
3-06 
3-08 
3-08 
3-09 
3-09 


A-02 
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Line Format Commands 


Horizontal Spacing 


Command Function Page 
LM Set left margin 4-02 
RM Set right margin 4-02 
PL Purge current output line 4-04 
SP Insert spaces in line 4-05 
TC Clear tab stops | 4-05 
TS Set tab stop 4-05 
ft Tab to logical tab stop 4-07 
LT Set left margin to logical tab stop 4-08 
RT Set right margin to logical tab stop 4-08 
TB Tab to absolute column | 4-07 
TF Tab with filler | 4-09 
LD Define leader characters 4-10 


Vertical Spacing 


Command Function Page 
NL New line 4-11 
NE New line, even margins 4-12 
SL Skip line 4-13 
PP Form paragraph | 4-14 
IS Specify spaces in paragraph identation 4-14 
PG Skip to top of next page 4-15 
PS Conditional skip to top of next page 4-15 


Line Justification 


Command — Function Page 
LJ Left justify text 4-16 
RJ Right justify text 4-17 
CN Center subsequent text 4-18 


EM Form even margins 4-18 


As-is Text 


Command Function | Page 
AS Begin subsequent as-is text 5-O1 
// End as-is text | 5-02 
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Appendix A 
Input/Output 
Command Function 
KY Switch input stream to console keyboard 
TY Switch output stream to console typewriter 
LP Switch output stream to line printer 
QP Switch output stream to text quality printer 
OS Return control to CODOS 
CM Set printing mode to continuous (default) 
NC Set printing mode to non-continuous 
Fi Assign diskette file to logical input file i 
Di Switch input stream to logical input file 1 
Ri Rewind logical input file i 
Ai Print or display logical input file i as-is 
FR Return input stream to logical input file 
ae Display comment on console | 
PR Restart printing at specified page number 
Table of Contents 
Command Function 
FO Open table of contents file 
C0 Close table of contents file 
BE Begin table of contents entry 
PO Insert as-is text to format table of 

contents file 
DOC User's Guide 
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6-01 
6-02 
6-02 
6-02 
6-03 
6-03 
6-03 
6-03 
6-04 
6-05 
6-05 
6-06 
6-06 
6-06 


Page 


7-01 
7-02 
7-03 
7-03 
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APPENDIX B. DOC DEFAULT CONDITIONS 


The following table is a list of all default conditions 
that are in effect when DOC is first called up. 


Formal Aspect Default 

Body length 54 lines 

Heading length 7 lines 

Footing length 5 lines 

Absolute left margin Column 10 
Absolute right margin § Column 70 

Left margin Column 10 

Right margin Column 70 
Paragraph indentation 5 columns 

Page numbering Off 

Line justification Left | 
Input stream Console keyboard 
Output stream Console typewriter or display 


Table of contents Closed 

File 1 Command line <filel> or closed 
File 2 Command line <file2> or closed 
File 3 Command line <file3> or closed 
Tab stops Cleared 

Heading text Spaces 

Footing text Spaces 

Page number restart Off 

As-is text mode Off 


Leader characters 
Page printing mode 
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Continuous 


Page 
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This appendix is provided to illustrate several examples 
of formatted text that have been prepared using DOC. The 
First example illustrates how tables can be formatted with 
the tabulation commands. Please note that commands can 
either be in upper or lower case. The following commands are 
used in the example: 7 


\cn, Center the heading 

\lj, Left justify text (stop centering) 
\nl, Begin a new line 

\tc, Clear tab stops 

\ts, Set tab stop 

\tt, Tabulate to a tab stop 

\sp, Place multiple spaces in the line 


The following table is from the "Agriculture Handbook 
No. 8." 


Input Text: 

\en 

Standards for Enrichment: \nl 

Minimum and Maximum Amounts of Required Nutrients Specified 
for Foods Labeled "Enriched"\nl 

(Milligrams per pound of product) \nl\nl1l\l1j 
\tc\ts20\ts25\ts30\ts35\ts40\ts45\ts50\ts55 

Item 

\ttl Thiamine Riboflavin\sp2Niacin\tt7\sp2\Iron 

\nl 

\ttl Min\sp2Max\sp2min\sp2Max\sp2Min\sp2Max\sp2Min\sp2Max 
\nl 

\nl 

Bread\ttl 1.1\tt2 1. 8\tt3 0.7\tt4 1.6\tt5 10.0\tté6 15.0 
\tt7 8.0 \tt8 12.5\nl1 

Cornmeal \ttl 2.0\tt2 3.0\tt3 1.2\tt4 1. 8\tt5 16.0\tté 24.0 
\tt7 13.0 \tt8 26.0\n1 

Farina\ttl 2.0\tt2 2.5\tt3 1.2\tt4 1.5\tt5 16.0\tté 20.0 
\tt7 13.0\tt8 [3] \nl 

Flour\ttl 2.0\tt2 2.5\tt3 1.2\tt4 1.5\tt5 16.0\tt6 20.0 
\tt7 13.0\tt8 16.5\nl 

Noodles\ttl 4.0\tt2 5.0\tt3 1.7\tt4 2.2\tt5 27.0\tt6 34.0 
\tt7 13.0\tt8 16.5\n1 

Rice\ttl 2.0\tt2 4.0\tt3 1.2\tt4 2.4\tt5 16.0\tt6 32.0 
\tt7 13.0\tt8 26.0\nl1 
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Output Text: 


Standards for Enrichment: 


DOC Examples 


Minimum and Maximum Amounts of Required Nutrients Specified 
for Foods Labeled 
(Milligrams per pound of product) 


Ltem 
Min Max Min 
Bread 
Cornmeal 
Farina 
Flour 
Noodles 


Rice 
The second example 
commands: 


change the 
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Max 


Min 


10.0 
16.0 
16.0 
16.0 
27.0 
16.0 


left margin 
center the heading 
left justify the text 
begin a new line 

set paragraph identation 
indent a paragraph 


Thiamine Riboflavin Niacin 


Max 


5:60 
24.0 
20.0 
20.0 
34.0 
32.0 


"Enriched" 


Iron 


Min 


8.0 


Max 


L2eod 


13.0 26.0 
13.0. 13] 

13.0 16.5 
13.0 16.5 
13.0 26.0 


Page 


is a poem and utilizes the following 
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Input Text: 

\1m20 

\en Jabberwocky 

\s12\1j\is2 

'Twas brillig, and the slithy toves 
\ppDid gyre and gimble in the wabe: 
\nlAll mimsy were the borogoves, 

\ppAnd the mome raths outgrabe. 

\sl2 

"Beware the jabberwock, my son! 

\ppThe jaws that bite, the claws that catch! 
\nlBeware the jubjub bird, and shun 
\ppThe frumious bandersnatch!" 

\s12 

He took his vorpal sword in hand: 
\ppLong time the manxome foe he shought- 
\nlSo rested he by the tumtum tree, 
\ppAnd stood awhile in thought. 
~\s12 

And, as in uffish thought he stood, 
\ppThe jabberwock, with eyes of flame, 
\nlCame whiffling through the tulgey wood, 
\ppAnd burbled as it came! 

\sl2 

One, two! One, Two! And through and through 
\ppThe vorpal blade went snicker-snack! 
\nlHe left it dead, and with its head 
\ppHe went galumphing back. 

\sl2 

"And hast thou slain the jabberwock? 
\ppCome to my arms, my beamish boy! 

\nlO frabjous day! Callooh! Callay!" 
\ppHe chortled in his joy. | 
\s12 

'Twas brillig, and the slithy toves 
\ppDid gyre and gimble in the wabe: 
\nlAll mimsy were the borogoves, 

\ppAnd the mome raths outgrabe. 
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Output Text: 
Jabberwocky 


‘Twas brillig, and the slithy toves 
Did gyre and gimble in the wabe: 
All mimsy were the borogoves, 
And the mome raths outgrabe. 


"Beware the jabberwock, my son! 

The jaws that bite, the claws that catch! 
Beware the jubjub bird, and shun 

The frumious bandersnatch!" 


He took his vorpal sword in hand: 

Long time the manxome foe he shought- 
So rested he by the tumtum tree, 

And stood awhile in thought. 


And, as in uffish thought he stood, 
The jabberwock, with eyes of flame, 
Came whiffling through the tulgey wood, 

And burbled as it came! | 


One, two!.One, Two! And through and through 
The vorpal blade went snicker-snack! 

He left it dead, and with its head 
He went galumphing back. 


"And hast thou slain the jabberwock? 
Come to my arms, my beamish boy! 

O frabjous day! Callooh! Callay!" 
He chortled in his joy. 


'Twas brillig, and the slithy toves 
Did gyre and gimble in the wabe: 
All mimsy were the borogoves, 
And the mome raths outgrabe. 


In the third example, a letter prints using supplemental 
operator input, the following commands are used: 


\lm, To change the left margin 

\ky, To keyin input from the console 

\**, To communicate with the operator 

\fr, To return control to the logical input file 
\em, To produce even margins 

\rj, To right justify text 

\sl, To skip multiple lines 
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Input Text: 
\en , 
The ABC Co. \nl 
10101 Binary Boulevard\nl 
Small Stone, Arkansas 
\sl2\rj | 
\**Enter the date followed by \fr 
\ky 
\sl2\em 
\** Enter Name followed by \fr 
\ky 
\nl 
\** Enter Address followed by \fr 
\ky 
\nl 
\** Enter City, State followed by \fr 
\ky 
\sl2 Dear Sir: 
\sl2 Many thanks for your recent order. 
\sl2 Since we have not had the pleasure of serving you 
previously, there will be a slight delay until the 
necessary credit data is received through normal credit 
channels. 
\sl2 You have our assurance, that as soon as satisfactory 
information is received, your order will be processed for 
immediate shipment. 
\sl12 Any additional information you can furnish to help us 
would be appreciated. 
\sl2 Please direct any written requests to: 
\1lm25\s12 
XYZ Credit Corporation\nl 
14 West Northern Drive East\nl 
Salt Flat City, Utah 
\sl2\rj 
Very Truly Yours, \s13 
John Q. Doe\nl 
Credit Manager 
\lm10\s12\1j 
JQD/rw\pg 


The operator is prompted during the printing of this 
letter for the day's date, the name, address, city, and 
state, After each operator supplied input, the DOC command 
"\fr" must be entered in order to return control to the 
letter file. The following illustrates what the letter would 
look like if the operator supplied these inputs: 


4/24/80\fr 

Quincy E. D. Smith\fr 
5 Fourth Avenue\fr 
Anywhere, Arizona\fr 
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Output Text: 
The ABC Co. 
10101 Binary Boulevard. 
Small Stone, Arkansas 
4/24/80 


Quincy E. D. Smith 

5 Fourth Avenue 

Anywhere, Arizona 

Dear Sir: 

Many thanks for your recent order. 

Since we have not had the pleasure of Serving you previously, 
there will be a slight delay until the necessary credit data 
is received through normal credit channels. 


You have our assurance, that aS soon as Satisfactory 
information is received, you order will be processed for 
immediate shipment. 


Any additional information you can furnish to help us would 
be appreciated. 


Please direct any written requests to: 
XYZ Credit Corporation | 
14 West Northern Drive East 
Salt Flat City, Utah 
Very Truly Yours, 


John Q. Doe 
Credit Manager 


JOD/ rw 
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The previous example can be slightly modified to cause 
the names and addresses to be obtained from another logical 
input file, rather than from the operator. In addition, a 
nea file can be used to obtain the date, if desired. For 

example, if the letter file (logical input file es had the 
following format: 


Input Text: 

\en 

The ABC Cp.\nl 

10101 Binary Boulevard\nl 
Small Stone, Arkansas 


\sl2 Dear Sir: 

\sl2 Many thanks for your recent order. 

\sl2 Since we have not had the pleasure of serving you 
previously, there will be a slight delay until the 
necessary credit data is received through normal credit 
channels. | | 

\sl2 You have our assurance, that as soon as satisfactory 
information is received, your order will be processed for 
immediate shipment. 

\sl2 Any additional information you can furnish to help us 
would be appreciated. 

\sl2 Please direct any written requests to: 

\im25\s12 
- XYZ Credit Corporation\nl 

14 West Northern Drive East\nl 

Salt Flat City, Utah 

\sl2\rj5 

Very Truly Yours,\s1l3 

John Q. Doe\nl 

Credit Manager 

\Im10\s12\1j 

JQD/rw\pg 

\rl\dl\nc 


DOC User's Guide Page C-07 


Appendix C : - poc Examples > 


The command "\d2" causes the date to be obtained from 
logical input file 2. The date file contains the following 
informations: | | ) 


Date in any format\r2\dl 


The "\r2" command causes the date file to be rewound so 
that a subsequent call for input returns the date again. The 
"\d1l" command returns control to the letter file. The 
commands in this file must be all on the same physical input 
record. Otherwise, rewinding the file would prevent the 
"\d1l" command from ever being detected. 


The name and address file, logical input file three, is 
obtained from the letter file by the "\d3" command. In this 
example, the name, address, city, and state are assumed to 
have DOC commands to cause the appropriate line spacing. In 
the manually entered example, the line spacing commands are 
contained in the letter file so that the operator did not © 
have to supply them. The name and address file entries must 
have the following format: 


NAME \nl ADDRESS \nl CITY, STATE \nl\dl 


As many letters print as there are entries in the name 
and address file. When the "end-of-file" condition is 
detected in logical input file 3, the DOC processor 
terminates the processing of all files, and returns control 
to the console keyboard. | 
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Absolute 


Argument 


Body 


Column 


Console 


Current 


Default 


DOC 


DOC 


File 


Filler 
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GLOSSARY 


When used to describe a margin or column 
position, identifies a margin or column 
position set by a command that overrides 
positions previously set. 


A number that defines a command; it can be 
a decimal value or a logical number. For 
example, in the command "\sp3," 3 is the 
argument, 


The block of lines available on a page 
for text. 


The space that a displayable character 
occupieS on a page. For example, under 
default conditions, left and right margins 
are set to columns 10 and 70, respectively, | 
thus making 60 columns available in a 
line on a page. 


Contains the display screen for displaying 
input or output text. | | 


When used to describe a column position, 
line, Or page, it identifies a column 
position, line, or page being worked 
upon at the moment. 


A condition assumed by DOC when the user 
fails to make a selection. See Appendix B. 


Codex Document Processor 


The system that executes DOC commands 
placed in input text to produce 
formatted output text. 


A body of information, identified by a 
filename, suffix, and logical unit number, 
and stored on a diskette. 


The sequence of two leader characters 
that fill spaces between items on a line, 
serving aS a guide to lead the eye frou 
One item to another. 
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Footing 


Heading 


Input Stream 


Input Text 


Justification 
Leader 


Line Printer 


Linked File 


Logical Input 
File 


Logical Tab 
Stop 


Logical Unit 
Number 


Output Stream 


Output Text 
Page 


Recursion 
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Glossary 


A block of lines at the foot of a page 


that may be left blank or may have 
information inserted in it. 


A block of lines at the top of a page 
that may be left blank or may have 
information inserted in it. 


A flow of information, serving as input 
text, whose source is controlled by the 
user by way of the console keyboard or 
logical input file. 


Text inserted on a page by the user by 
way Of the console keyboard or logical 
input file. 


Forcing text on a page to the left and/or 
right margin. 


Any displayable character used to make up 
a filler. 


The printer that produces output text. 


A Single file produced by joining 
individual files. 


A file assigned, in logical order, when 
files are specified by filename by way 
of the DOC processor anvonsng command 
Or by "Fi" command. 


A tab stop identified by logical 
number, 


The number assigned by the user or by 
default to identify the drive unit the 
disk file resides on. 


A flow of information, displayed or 
printed as output text by way of the 
console, console typewriter, or printer. 


Text displayed or printed, formatted 
by DOC commands. 


Space available for text. A page consists 
of a heading, body, and footing. 


To repeatedly get an input file to 


obtain input text. 
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Suffix This identifier is assigned by the user 
or by default to refer to a particular 
filename in order to differentiate 
between files of the same name. 


Table of A file created automatically when table of 


Contents File contents commands are encountered. Refer 
to Chapter 7. 
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